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Copyrianht 1977, North Star Computers, Ine. 


REVISION 5 


INTRODUCTION 


The North Star Disk Operating System (DOS) was designed and 
implemented by staff members of North Star Computers, Inc. for 
use in conjunction with the North Star MICRO DISK SYSTEM. The 
DOS permits a user to issue various "commands" from a terminal 
for maintaining and using files on the disk(s). The DOS also 
provides “library routines" which may be called from user 
software. These library routines will primarily be of interest 
to users who will be developing their own system software, as 
opposed to those users who will primarily use application 
programs such a BASIC. 


The DOS occupies 2.5K (A®® hex) bytes of RAM, including 256 bytes 
of RAM for user I/O routines. The origin of the DOS is 20090 hex 
in the standard version. 


The North Star DOS is intended for use only with the North Star 
MICRO DISK SYSTEM, and no license is granted for any other use. 
Improved copies of the Version 2 DOS, as they become available, 
may be obtained for a nominal copying charge. 


Before the DOS can be used on a specific computer configuration, 
the instructions in the PERSONALIZING YOUR VERSION OF THE DOS 
section must be followed. It is suggested that you read the 
entire manual and then follow those instructions. 
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DISK ADDRESSES 


As described in the hardware documentation, information is stored 
on the disk in 256-byte "blocks". Each diskette consists of 35 
concentric "tracks" with 1% sector positions per track. A block 
exists at each sector position. Every block on the disk is 
identified by a unigue “disk address" - an integer from 9 through 
349. Por example, the block at track 27, sector 3 has disk 
address 273. Track @ is the "outermost" track, and track 34 is 
the "innermost" track. 


FILES 


The primary DOS function is to permit the creation, deletion and 
use of files on disk(s). A file is an integral number of blocks 
of data with sequential disk addresses. For example, a 
particular file might occupy disk addresses 17 through 95 on a 
diskette mounted on unit 2. 


The first four blocks on each diskette contain a "file directory" 
which specifies a symbolic name, base address, length and type 
information for eacn file on that diskette. The symbolic name 
may be up to 8 characters long, and may include any characters 
except blank and comma. The length of a file may be up to 346 
blocks. A directory may contain as many as 64 entries. No two 
files in a directory may have the same name, but it is possible 
for files of the same name to be in directories of diskettes 
mounted simultaneously on separate units in a multi-unit system. 


Sue 


c North Star Disk Operating System 


FILE TYPES 


One byte in the file directory entry for each file specifies the 
"type" of the file. Depending on the specific type, additional 
bytes in the entry may have special meaning. (The details of 
file directory entries are given in a later section). Only four 
of the 256 possible file types have been assigned to date: 


type @ - Default type. All new files are assigned type 9 until 
explicitly changed. 


type 1 - Machine language program. This file type identifies a 
machine language program (object code) that may be 
executed directly from the DOS with the GO command. 


type 2 - BASIC program. This type of file is used to identify a 
BASIC program that can be LOADed or SAVEd from BASIC. 


type 3 - BASIC data file. This type of file may be read and 


written by BASIC pvrograms for data storage and 
retrieval. 
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COMMANDS 


Instructions are issued to the DOS from the terminal by typing 
"commande". The command format is a 2-letter mnemonic followed 
by any required arauments. Araquments are separated fror the 
cormand mremonic ana from each other by @ single blenk. A 
commana must be terminseted by a carriege return before the DOS 
takes any action. If a typing error occurs during typing of a 
commana, an ét-sian (@¢) ray ke tyved to permit re-typing of the 
commana. Also, én underline or left-arrow may be tvnood te erase 
the previcusly typed chéracter. 


when a file name is required as a comménd aroument, tne disk unit 
number (in @ multi-unit system) may be specified by immediately 
rOlLIGwing the Lile nare with “,1";, “»2" or *,3"<. . CGtherwise, urit 
1 is assumed. Some sample file name formats are: 


ABC Testlz3s4,3 SASLC yd 


Commands may be typed whenever the prompt character (*) epodears 
et the left marcin of the terminal. 
Li <Optyonel wie ¢> 
This commana will list the entire contents of the directory on 
the ciskette mounted on the specifiec unit. If no unit is 
specifie., then unit 1 is assumed. For each file, its ') 
cymbolic neme, startino disk éddress, lenath and type will be : 
Printec. For type ] files, the co-address will also be 
printed. To crematurely terminéete a listina, @ control-C mey 
be typed. 


O) 
"3 


<file neme> <lenagth> <optional stért éedaress> 

This commence will create a new file on the unit indicated by 
the file neme. The length argument specifies the number of 
Z256-Eyte blocks. If no stértingo eddress is given, tnen tne 
file will start after the “last” (innermost) file currently 
allocetea on the diskette. Otherwise, the supplied stértina 
edacress will Fe used. This command will only create a file 
Clrectory entry - no accessing of tne file itself will he 
acne. 


bi <ftile name> 
TALS commanc will aelete @en existina file directory entry on 
tne incicatead unit. No actual accessing of the file blecks 
will be Gone. The DE command, in cenjunctic!:: with the CR 
commana, may be used to charace the lenath of a file on the 


arene 
n OLS Kh. 


Co <optional unit #> 
This commanc mey Fe usec to "compact" the file gpece on the 
ciskette rourntea cn the indicated unit. Any unusec disk sDace 
between existing files will be eliminatec by moving files 
towara track ®@. The CO ccommard may be used to reclaim file 
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LF 
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CF 
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space efter a file is deleted or shortened. The CO command 

will not work properly if files on the Gdisk have any overlap 
with each other. This command requires use of the 2.5K RAM 

area immediately following the DOS. 


<file name> <file type> <optional ao-aadress> 

This command is used to change the type of the specified file 
on the indicated unit. If type 1 is specified, ther the third 
argument must be supplied to specify the "go-address". 


<file name> 

This command is usec to load the specified file into RAM from 
the inGicated unit and begin execution. The GO commardc mey be 
used only with type 1 files. The GO commenc will reeo the 
entire file into RAM beaqinning at the go-eddress, end then 
jump to the go-address. Obviously, the first byte of the file 
must be tne entry point of the prooram. 


<hex RAM acaress> 

This command will cause the computer to jump to the specified 
RAM address. It provides a way of executing preorams which 
exist in the address space of the computer. Do nct confuse 
this commend with the GO commend. 


<file name> <hex RAM address> 

<file name> <hex KAM address> 

These commands may be used to load or save @ Gdisk file to or 
from RAM. The entire contents of the file will be reao or 
written to or from the specifiec RAM edadress. 


<source file name> <“estination file néeme> 

This command may be used to copy one file to another. The twe 
files may be on the same or separate units. The file copy is 
pertormea only if the destination file 1s at least es tderge es 
tne source file. The file type and the type dcepencent 
information are aleo copied. This command requires use of tne 
2.5K RAM erea immediately following the DOS. 


<source unit #> <destination unlit #> 

This commangé will copy the entire contents of the diskette 
mounted on the specifiea source unit to the diskette mounted 
on the specified cestination unit. The 2.5K of RAM erea 
immediately followine tne DOS are reaquired for this command. 


<disk address> <hex RAM address> <# of blocks> 

<disk address> <hex RAM address> <# of Flocks> 

These commands may be used to reac or write a specified unit 
Girectly to or from RAM. The WR and RD commands should be 
used with creat care, es typing errors can have catastrophic 
effects. The Gisk eddress may optionally be followed by ",1", 
3" o¢ *53" HO Gneicaete & perticuler unit. Otherwise, unit J 
is essumed. Note that a method of copying one diskette to 
another in a single drive system would involve repeated use of 
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IN 


bY 


the kD and WR commands. 


<optional unit #> 

This command should be used to initialize each new diskette to 
be used in the system. The IN command writes each block on 
the specified drive witn ASCII blank characters (20 hex). 
This initializes the Girectory and also guarantees that no 
"hard @isk error" can result from éeccess to an uninitialized 
file block. The IN command takes ebout 15 seconds. Needless 
to say, one should make sure that the proper aiskette 1s 
mounted before issuing the IN command. Note that the IN 
command, in order to Grive the disk at high speed, uses tne 
2.5K RAM area immediately following the DOS. Also note that 
eh initialized diskette does not contain @ copy of the DOs. 


<opticnal unit ¢> 

The DI command may be used to test the unit or to verify the 
usability of a diskette. This command will continuously write 
eé chancing pattern and then read the diskette on the specifiec 
unit. Note that 4ll information previously stored on the 
Giskette will ke overwritten, and that a tested diskette must 
be initialized before use. If a hard disk error occurs, then 
the test will stop and print out the hard disk error messaqce. 
The command may be stopped by typing @ control-C. Note that 
the 2.5K block ot memory immediately followina the DOS will be 
used for this ccmmenc. i 
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DISK SYSTEM START-UP 


After power-on, or when it is desired to re-start the disk 
system, the 89898 or Z8@ computer must be forced to begin 
execution at the PROM bootstrap program starting address (E999 
hex in the standard version). The PROM bootstrap program will 
read one 256-byte block from unit 1, disk address 4 into RAM at 
the DOS starting address (2000 hex in the standard version). 
After reading in the block, the bootstrap will branch to the DOS 
Starting address. The program in the first block of the DOS will 
proceed to read in the nine blocks from disk addresses 5 through 
13. Then the DOS will print the prompt character (*) and await a 
command from the terminal. 


Once the DOS has been started, it is no longer necessary to leave 
Ene diskette in unit 1, The DOS is fully resident in RAM; and 
makes no disk accesses unless asked to do so. Furthermore, the 
DOS does not maintain any copies of the diskette file directory 
in RAM between commands. Thus it is possible, for example, to 
obtain listings of the file directories of several diskettes Dy 
inserting them one at a time and then issuing the LI command. 
Also, 1t 1S possible to copy: one diskette to another in a single 
drive system by repeatedly exchanging dikettes and doing the 
appropriate sequence of RD and WR commands or LF and SF commands. 
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PERSONALIZING YOUR VERSION OF THE DOS 


The following procedure must be followed the first time you 
Operate the DOS after installing it in your computer system. 
Read this entire section before starting the procedure. After 
you have followed this procedure, the DOS will communicate 
directly with your terminal immediately after disk system start- 


up. 


The DOS is designed to be able to interface to any conceivable 
terminal I/O conventions. There are four routines used oy the 
DOS: character input (CIN), character OVeCOUe (COUT), control-—cC 
detect (CONTC), and terminal initialization (TINIT). In the bos 
which you receive with your MICRO DISK SYSTEM, each of these 
routines is merely a jumo to self loop. The location of these 
routines is shown in Appendix 1. Thus, when you first perform a 
disk system start-up sequence, the DOS will be stuck in a branch 
to self loop at TINIT: 


At this point, remove the pre-recorded diskette and insert the 
second diskette supplied. Now stop the computer and enter your 
Own terminal I/O subroutines in the last 256 bytes of tne DOS 
(from 29006 hex through 29FF hex in the standard version), 
carefully following the interfacing rules described in Aovendix 
£4 (There 1S a sample set of I/O routines in Appendix 3.) Next, 
patch the four JMP intructions to contain the addresses of your 
routines. 


Now, force your computer to branch to TINIT. (LE. Ls inoor tent 
that during the entering of your I/O routines, you do not change 
the computer stack vointer.) The terminal should Print out an 
asterisk (*) and the DOS should be awaiting a command. 


pe sure tne second diskette, and not the pre-recorded diskette is 
properly inserted in unit 1. Now, initialize the second diskette 
with the IN command. 

*IN 1 
Next create a file with the name DOS. This will discourage your 
later elliocating a file on tonof tne disk Space that will hold 
tne DOS. 

FL OOS pb 18 


Now write out the DOS from RAM (2@00 hex in the standard version) 
tO Gisk unit 1. 


*SF DOS 200% 
You snould now be able to start your personalized version of the 


DOS by branching to the PROM bootstrap start address (E900 hex in 
the standard version). 
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PERSOCNALIZING YCUR VERSION OF BASIC 


When you have successfully created ycur personal version of the 
DOS on the second diskette, vou may vroceesc to creating your 
personal version of BASIC on the second diskette. First, insert 
the pre-recorded ciskette in unit 1, and reed BASIC into RAM at 
the location where it is intendeda to ke run ‘?A@@ hey in the 
Standard version). BASIC reouires at least 10K of RAM. 


*LF EASIC 2A08@ 


iNcw remove the pre-recorded Cciskette and insert the secord 
Giskette. Create an entry in the file directory for RASIC, set 
the type and set the co-éddress: 


*CR BASIC 45 
eTY BASIC. 2. 2avy 


The recion in KAM where BASIC ellocates user BASIC programs end 
deta is set up in the BASIC initialization Sequence (see Appenc1x 
2). No modification is necessary if you use ée standard version 
end are using 16K of mesory bealnning at z2uve hex, ILE you heve e 
non-standéerc version of BASIC or you wish to change the region 
where BASIC allocates vrograms and Gata, then vou must mcdify the 
SooOrcopriate GAL EPREtruct ions if tne FASIC Soltwere. if you 
agecide to make such modifications, stop your coirputer at this 
point and weke the appropriate mocificaticns to the covy of RASIC 
now in RAM. Then re-start the DOS by branchirg to the hootstran 
edaress. whether or not you méce tne ekove mcedification, now 
write BASIC out onto the secenc ciskette: 


1 


*SF BASIC 2AM 
it ¢houlad now be oossible to start BASIC by typing 
*GO BASIC 


The I/O recuirements of EASIC are handled by callina the BOS 
terrinal a/C routines, 
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DISK ERRORS 


Every disk operation is tried 18 times by the DOS before 
reporting failure. After the 1@ tries, the disk address is 
orinted followed by the message "HD?", and the DOS will await 
further commands. For example, 


1 234HD? 
% 


informe -of A GuSK error of. Unit Ll. at track 23, Sector 4. 


A disk error can result from attempting to use an improperly 
inserted diskette (e.¢., forgetting to close the drive latcn) of 
from attempting to read uninitialized or improperly written data. 


It is possible to specify to the DOS that after every write 
operation performed, an attempt be made to verify the written 
data against the data in RAM. ‘This modification will result in 
slower operation, and most users should find that it is not 
needed. To make the modification, load a copy of the DOS into 
high RAM, change the RWCHK byte from @ to 1 (see Appendix l), 
then write the updated copy of the DOS to diskette. 
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FILE DIRECTORY STRUCTURE 


This section gives a detailed description of the format of 
entries in the file directory on a diskette. The file directory 
occupies disk addresses @ though 3, with each of these four 
blocks holding sixteen 16-byte entries. The symbolic name of the 
entry is the first 8 bytes of an entry. An empty entry 1s an 
entry with 8 blanks (28 hex). Following the symbolic name in an 
entry, the disk address (2 bytes), the file size (two bytes) and 
the type (1 byte) follow. The last three bytes of an entry are 
type dependent. In particular, for a type 1 file (GO file), the 
two bytes following the type byte contain the go-address, and for 
a type 2 file (BASIC program) the byte following the type byte 
specifies how many blocks of the file actually contain valid 
data. 


File directory entry: 


bytes @-7 symbolic name of entry 
bytes 8-9 disk address 

bytes 19-11 number of blocks in file 
byte 12 file type 

bytes 13-15 type-dependent information 
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DOS LIBRARY ROUTINES 


This section describes how user machine language software may 
interface to the DOS for the accessing of disk files. 


Appendix 1 shows the entry points for each of the routines to be 
described here. The exact interfacing requirements are described 
in the appendix. The DOS uses the stack pointer existent at call 
time, and some of the DOS library routines may require as much as 
39 bytes of stack storage. Note that the DOS May be re-entered 
without using the bootstrap PROM. Now follows a discussion of 
@acn library routine. 


D LOOK 
This routine searches for a specified file name in the 
directory of the indicated disk unit. If the specified name 
begins with a blank, then an "empty" file Girectory entry is 
looked up. On failure, HL is set to the value of the first 
free disk address on the indicated unit following the last 
file on the diskette. 


On success, HL contains a pointer into a buffer in DOS RAM 

that has a copy of the sought entry. The pointer addresses 
the first byte following the symbolic name laGe, Byte 8). 

Also, on return, the ACC specifies the disk unit which was 

determined from the name passed as argument. 


DWRIT 
This routine is used to write back to diskette an updated 
file directory entry which was previously found using DLOOK. 
No disk activity may occur between the DLOOK and the DWRIT 
oF 2G oe 


DCOM 
This routine may be used to issue an arbitrary disk read or 
write command. On a read reauest, DCOM will try 18 times 
for a successful read before giving up and branching to 
HDERR. DCOM will fail return if the supplied arguments are 
out of bounds. However, great care should be used before 
calling DCOM with incorrect arguments. 


DOS This is an entry point to the DOS command processor. It can 
be used to return control to a loaded DOS without requiring 
a PROM bootstrap load. 


HDERR 
HDERR branches to DOS code that prints an error message and 
then enters the DOS command processor. HDERR is branched to 
within the DOS whenever a read attempt is impossible to 
successfully complete after 19 retries. If your software 
wishes to retain control in the event of a hard disk error, 
your software should modify the address of the HDERR JMP 
instruction 46.9., LEXI H;ADDR= SHLD HDERR+1). The stack 
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cepth at the time of a branch to HDERR from within the LOS 
1s inceterminate. [Note: Scftware for dealinc with hard 
Gisk errors is notoriously difficult. It is suagested that 
cue to the expected low frequency of hard disk errors, for 
most applications the existina HDERR action will be 
Sutticient. Hara cisk errors will result primarily from 
careless use (€.cg. foroettina to initialize a diskette, or 
from removing 4 diskette while writing is in prooress). 
Hard disk errors can also result from pewer fallure Curing 
writing, or from a harcware system failure. |] 


~~ 4 
KH 
Ui 
- 


This routine will list the file directory of the specified 
drive. The listing format will ke exactly the same es the 
Listing £ormat octained with the DOS LI command. 


Nete: The procedure for creating a new file using the above 
routines woulda be the following: First use DLOOK to search for 
the GceSired new name - if DLOOK succeeds then a file of that rneme 
areagy exists and should not be created. On failure, HL will have 
the aqisk eacress which should be used as the startina acdress of 
tne new file. Next, use DLOOK to fird ar empty directory entry 
by locking up a Eléenk name. If this call to BLOOK fails, then 


hoe Gcirectory £feiis. On suecess, use the vointer in HL to cory 
the new file neme into the directory entry, and copy in t':e @isk 


accress and lencth end type information. Finally, call DWRIT to 
cooy tne new directory entry back to the disk. 
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Appencix 1: DOS I/O Routines and Entry Points 


4O00 * 
GVOP *NORTH STAR DISK OPERATING SYSTEM 
9009 * 
I999d ORG 2009H STANDARD VERSION ORIGIN VALUE 
2993 Bp is THESE CELLS ARE RESERVED 
2480D x | 
299D * 
2088D *THIS IS THE CHARACTER OUTPUT ROUTINE 
2090D *THE CHARACTER TO BE OUTPUT MUST BE IN THE B REGISTER. 
209D *DEVICE NUMBER MAY BE SUPPLIED IN ACC, IF DESIRED. 
200D *ON RETURN THE CHARACTER MUST ALSO BE IN THE ACC. 
200D *NO OTHER REGISTERS MAY BE MODIFIED. 
290D C39D29 COUT .uMPe COogT YOUR ROUTINE MUST DO A RET 
291d . 
2019 *THIS IS THE CHARACTER INPUT ROUTINE. 
2319 *DEVICE NUMBER MAY BE SUPPLIED IN ACC, IF O&SIRED. 
2918 eTHs J=B17 ASCII COOK MUST BE RETURNED IN THE ACC. 
2319 *NO OTHER REGISTERS MAY BE MODIFIED 
29198 C3192 CIN JMP CIN YOUR ROUTINE MUST DO A RET 
2313 - 
2913 *THIS IS THE TERMINAL INITIALIZATION ROUTINE 
2913 *ALL REGISTERS MAY BE USED. 
2913 *IF NOT NEEDED, MERELY PATCH IN A RET. 
2013 C31329 TINIT JMP TINIT 
2916 m 
20156 *THIS ROUTINE DETECTS A CONTROL-C 
2015 *IF Z IS SET ON RETURN, THAT MEANS A CONTROL-C wAsS IY PED. 
2916 *OTHERWISE, IF NO CHARACTER WAS TYPED OR A CHARACTER OTHER 
2416 * THAN CONTROL-C WAS TYPED, 2 MUST NOT BE SET. 
2016 *CONTC SHOULD RETURN IMMEDIATELY IF NO CHAR WAS TYPED, 
2916 * NOT WAIT FOR A CHARACTER AND THEN RETURN. 
2016 *ALL REGISTERS MAY BE USED. 
2916 C31629 CONTC JMP CONTC 
2319 * 
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C39009 


C30000 


C38000 


C33900 


C30909 


C3005 


Bg 


*DOS LIBRARY ROUTINE ENLRY POINTS 
x 


*THIS ADDRESS IS BRANCHED TO ON HARD DISK ERRORS 

HDERR JMP Q 0 IS NOT THE REAL ADDRESS 

x 

“THIS IS THE FILE DIRECTORY LOOKUP ROUTINE 

*ACC MUST CONTAIN THE DEFAULT UNIT NUMBER (NORMALLY 1) 
*HL=POINTER TO FILE NAME IN RAM, 

*POLLOWED 3Y EITHER A BLANK OR CARRIAGE RETURN. 

*PAILURE If CARRY SET. ON FAILURE, HL=fIRST FREE DISK ADDRESS 
*ON SUCCESS, ACC=THE DISK UNIT INDICATED, AND HL HAS A POINTER 
*TO THE EIGHTH BYTE OF A COPY Of THE EWTRY IN DOS RAM 

DLOOK JMP Q 0 IS NOT THE REAL ADDRESS 

x 


*THIS ROUTINE WILL WRITE A DIRECTORY ENTRY BACK TO DISK 
*NUO ARGS ARE NEEDED. MUST FOLLOW DLOOK. 

DwRIT JMP Q 8 IS NOT THE REAL ADDRESS 

x , 

*THIS ROUTINE MAY BE USED TO ISSUEB A DISK COMMAND 
*ACC=NUMBER OF BLOCKS 

*B=COMMAND (Y=WRITE, 1=READ, 2=VERIFY), C=UNIT NUMBER 
*DE=STARTING RAM ADDRESS, HL=STARTING DISK ADDRESS 
*RETURN WITH CARRY SET MEANS ARGUMENTS WERE ILLEGAL 
DCOM JMP Q 0 IS NOT THE REAL ADDRESS 

x 

*THIS ROUTINE MAY BE USED TO LIST A FILE DIRECTORY 
*ACC=DISK UNIT 
LIST JMP Q@ 0 IS NOT THE REAL ADDRESS 

* 

*THIS ADDRESS IS AN ENTRY POINT TO THE LOADED DOS 
DOS whe 2 0 IS NOT THE REAL ADDRESS 

k 


‘IGLS NEAT BYTE TS A FLAG USED SY DOS. 

*IF 9, THEN READ-AFTER-WRITE CHECK IS NOT DONE, 
*IF 1, THEN READ-AFTER-wRITE CHECK IS DONE. 
RWCHK DB ¥g 

x 

x 
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Appendix 2: BASIC Entry Points 


8200 
BOGE 
DOOD 
OOO 
2A0@ 
Z2ADQ 
2A91 
2A04 
ZA95 
2A98 
2ANB 
ZAQE 
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* 


*NORTH STAR BASIC, VERSION 6 
* 


ORG 


EPO XRA 
JMP 
EPI STC 
EPL LRT 
LxI 
JP 


2ZAQUH 


A 
EP11 


H,ENDBAS 
D,SFFFH 
START 


STANDARD VERSION ORIGIN 


INITIALIZATION ENTRY POINT 


CONTINUE ENTRY POINT 

FIRST CELL OF PROGRAN REGION 

LAST CELL OF CONTIGUOUS MEMORY 
ENDBAS AND START ARE NOT REALLY @ 
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Appendix 3: Sample I/O Routines 


* 
* 


*SAMPLE I/O ROUTINES FOR PERSONALIZING DOS 
k 


STAT 
Be wR) 
OBIT 
DATA 


CHIN 


CHOUT 


INIT 


CCONT 


* 


*APLTER ENIERING THESE ROUTINES; 


ORG 2900H 


EQU @ 
BOUL 
EQU 2 
BOU. sk 


In STAT 

ANI IZ3IT 
Je AAIN 

IN DATA 

ANI 7F4& 

Bore 


IN STAT 

ANI OBIT 
JZ CHOUT 
MOV A,B 

OUT DATA 
RET 


RET 


IN STAT 
ANI IsIT 
ARE LBL 
RNZ 

IN DATA 
ANI 7FH 
rl 3 
Kol 


FOR THIS EXAMPLE, ASSUME I/O STATUS PORT IS @ 
ASSUME BIT @ IS KEYBOARD STATUS BIT 

ASSUME BIT 1 IS OUTPUT STATUS BIT 

ASSUME DATA IN AND OUT PORT IS 1 


GET KEYBOARD INPUT 


STATUS 


TEST FOR INPUT STATUS READY 


LOOP IF NOT READY 
READ THE CHARACTER 
MASK DOWN TO 7-BIT 


GEV OUTPUT STATUS 


ASCII 


MASK DOWN TO OUTPUT STATUS BIT 
LOOP IF NOT READY FOR OUTPUT 
COPY THE CHARACTER TO ACC 


NOTE THAT CHAR IS NOW IN ACC TOO 


TINIT NOT NEEDED IN MANY SYSTEMS 


GET STATUS BYTE 


SELECT KEYBOARD STATUS BIT 
SET Z FLAG FALSE IF NC INPUT 


RETURN IMMEDIATELY IF NO CHAR TYPED 


GET THE TYPED CHAR 


MASK DOWN TO 7-BIT ASCII 


Set & LE CONTROL]C, 


ELSE CLEAR Z 


* IN ‘THE DOS JMP INSTRUCTIONS TO: THESE ROUTINES. 


* 
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PATCH THE CORRECT ADDRESSES 
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